Skip to content

Drop aria-labels that duplicate visible text in first-run setup - #475

Merged
charneykaye merged 1 commit into
mainfrom
chore/a11y-dedupe-aria-labels
Aug 22, 2026
Merged

Drop aria-labels that duplicate visible text in first-run setup#475
charneykaye merged 1 commit into
mainfrom
chore/a11y-dedupe-aria-labels

Conversation

@charneykaye

Copy link
Copy Markdown
Contributor

Follow-up 360 cleanup pass over #474.

Three containers in the first-run welcome and installing steps carried an aria-label equal to their own visible heading:

  • Welcome "Not a chatbot. Not a mirror." promise note
  • Installing "While that downloads…" section
  • Installing "Your first missions" list (labelled by its visible <h3>)

Each caused a screen reader to announce the heading twice (duplicating visible text in aria-label is a documented anti-pattern). Removed the redundant labels; the visible headings remain the accessible names, and content is announced once.

The one genuinely non-redundant label — the how-to-play ordered list, whose "How to play" heading is not rendered visually — is intentionally kept.

No visual change. tsc clean, eslint unchanged from baseline, vite build clean, and FirstRunWizard's 72 tests (including the while-you-wait content assertions) pass.

🤖 Generated with Claude Code

https://claude.ai/code/session_01C9WmcidRL3ABq7qhWHUsrG

Follow-up cleanup to #474. Three containers in the welcome/installing
steps carried an aria-label equal to their own visible heading, so a
screen reader announced each heading twice. Removed the redundant labels
(WCAG anti-pattern); the visible headings remain the accessible names.
The one non-redundant label (the how-to-play list, whose heading is not
shown visually) is kept.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C9WmcidRL3ABq7qhWHUsrG
@charneykaye
charneykaye merged commit c641656 into main Aug 22, 2026
17 checks passed
@charneykaye
charneykaye deleted the chore/a11y-dedupe-aria-labels branch August 22, 2026 21:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant